NBE ONPS Article 7 Metadata Gateway - Survival Guide

: NBE ONPS Article 7 Metadata Gateway Survival Guide



1. Introduction: What is the Article 7 Requirement?
Under the National Bank of Ethiopia’s (NBE) Overseas National Payment System (ONPS) directive, Article 7 mandates that all licensed Fintechs and Financial Institutions must provide a real-time "Metadata Gateway." This ensures that every cross-border transaction is accompanied by granular data for regulatory oversight, AML (Anti-Money Laundering), and CFT (Counter-Financing of Terrorism).



2. Core Technical Architecture
The Metadata Gateway is not a simple batch-upload system; it is a real-time API integration between the Fintech’s core system and the NBE’s monitoring server.

* Communication Protocol: RESTful API over HTTPS.
* Data Format: Primarily JSON (JavaScript Object Notation).
* Security:
* TLS 1.2 or higher is mandatory for data in transit.
* IP Whitelisting: NBE servers will only accept requests from pre-registered Fintech server IPs.
* Authentication: Mutual TLS (mTLS) or OAuth2.0 (Bearer Tokens) depending on the specific integration phase.



3. The Metadata Payload (The "What")
For every transaction processed, the following metadata fields are typically required:
* Transaction ID: Unique hash or UUID.
* Sender/Receiver Info: Full names, addresses, and KYC levels.
* Purpose Code: Standardized codes (e.g., Family Support, Education, Trade).
* Source of Funds: Verification of where the money originated.
* Geolocation: IP address and GPS coordinates (if available) of the transaction origin.
* Device Fingerprint: Unique ID of the mobile device or browser used.



4. Latency and Throughput Requirements
Real-time means Zero Lag.
* Timeout Threshold: The NBE Gateway usually expects a response or acknowledgment within 200ms - 500ms.
* Queue Management: Fintechs must implement message queuing (e.g., Kafka or RabbitMQ) to ensure that if the NBE Gateway is temporarily down, data is retried and not lost.



5. Compliance Checklist for Fintechs


1. KYC Alignment: Ensure your onboarding flow captures all fields required by the NBE Metadata schema.


2. Audit Logs: Maintain local immutable logs of all metadata sent to the Gateway for a minimum of 10 years.


3. Error Handling: Implement robust HTTP 4XX and 5XX error handling. A failure to report metadata can lead to the "Freezing" of the transaction capability.



🇪🇹

: የኢትዮጵያ ብሔራዊ ባንክ ONPS አንቀጽ 7 ሜታዳታ ጌትዌይ መመሪያ



1. መግቢያ፡ የአንቀጽ 7 አስፈላጊነት
በኢትዮጵያ ብሔራዊ ባንክ የውጭ አገር ክፍያ ሥርዓት (ONPS) መመሪያ መሠረት፣ አንቀጽ 7 ማንኛውም የፊንቴክ (Fintech) ተቋም እያንዳንዱን የገንዘብ ዝውውር የተመለከቱ ዝርዝር መረጃዎችን (Metadata) በቅጽበት ለባንኩ ሪፖርት እንዲያደርግ ያስገድዳል። ይህ አሰራር ህገ-ወጥ የገንዘብ ዝውውርን (AML) ለመቆጣጠር የሚረዳ ዋና መሣሪያ ነው።



2. ቴክኒካዊ መዋቅር (Technical Architecture)
የሜታዳታ ጌትዌይ በቀን መጨረሻ የሚላክ ሪፖርት ሳይሆን፣ ዝውውሩ በሚከናወንበት ቅጽበት የሚሰራ የኤፒአይ (API) ግንኙነት ነው።

* የግንኙነት ዘዴ: RESTful API (HTTPS በመጠቀም)።
* የመረጃ ቅርጽ: JSON (በብዛት ጥቅም ላይ የሚውል)።
* ደህንነት (Security):
* TLS 1.2+: መረጃው በሚተላለፍበት ጊዜ እንዳይጠለፍ ሚስጥራዊነቱ የተጠበቀ መሆን አለበት።
* IP Whitelisting: ብሔራዊ ባንክ መረጃ የሚቀበለው አስቀድመው ከተመዘገቡ የፊንቴክ ሰርቨር አይፒዎች (IPs) ብቻ ነው።



3. የሚላኩ መረጃዎች ዝርዝር (Metadata Payload)
እያንዳንዱ የገንዘብ ዝውውር ሲከናወን የሚከተሉት መረጃዎች መካተት አለባቸው፡
* የመለያ ቁጥር (Transaction ID): ለእያንዳንዱ ዝውውር የሚሰጥ ልዩ መለያ።
* የላኪ እና ተቀባይ መረጃ: ሙሉ ስም፣ አድራሻ እና የKYC (ደህንነት) ደረጃ።
* የዝውውሩ ዓላማ: ለምሳሌ ለቤተሰብ እርዳታ፣ ለትምህርት፣ ወይም ለንግድ መሆኑን የሚገልጽ ኮድ።
* የመሣሪያ መለያ (Device Fingerprint): ዝውውሩ የተከናወነበት ስልክ ወይም ኮምፒውተር መለያ።



4. የፍጥነት እና የጥራት መስፈርቶች
"በቅጽበት" (Real-time) ማለት ምንም ዓይነት መዘግየት የሌለው ማለት ነው።
* የጊዜ ገደብ: የብሔራዊ ባንክ ሲስተም መረጃውን ከ 200 እስከ 500 ሚሊ-ሰከንድ (ms) ባለው ጊዜ ውስጥ እንዲደርሰው ይጠብቃል።
* የመረጃ ማከማቻ (Queuing): የብሔራዊ ባንክ ሲስተም ለተወሰነ ጊዜ ቢቋረጥ እንኳን፣ ፊንቴኩ መረጃውን ደርቦ በመያዝ ሲስተሙ ሲስተካከል በድጋሚ የመላክ (Retry Mechanism) አቅም ሊኖረው ይገባል።



5. ለፊንቴክ ተቋማት የሚመከሩ ተግባራት


1. የመረጃ አሰባሰብ: የእርስዎ መተግበሪያ (App) ብሔራዊ ባንክ የሚፈልጋቸውን ሁሉንም መረጃዎች መሰብሰቡን ያረጋግጡ።


2. የኦዲት መዝገብ: ወደ ጌትዌይ የተላኩ መረጃዎችን ቢያንስ ለ10 ዓመታት በጥንቃቄ ያስቀምጡ።


3. ስህተቶችን ማስተካከል: መረጃ ሳይላክ ዝውውር ማከናወን በሕግ ያስቀጣል፤ ስለዚህ የሪፖርት ማድረጊያ ሲስተምዎ ሁል ጊዜ ዝግጁ መሆኑን ያረጋግጡ።